home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 201-225 / 219 / deepsky / sac50.zoo / pc-sac-report-gen.arc / SACREP.TXT < prev   
Text File  |  1989-05-15  |  12KB  |  216 lines
  1.          SACREP.ARC  Version 5.0  -  The Quick Overview 
  2.                    by A.J. Crayon and Dan Ward 
  3.                           May 1989 
  4.  
  5. SACREP.EXE is a report generator program that can be used against the 
  6. SAC50.DBF file.  This program is designed as a quick and dirty way to 
  7. generate observing lists from the SAC50 database for those who are not 
  8. conversant with database programs.  It can also be used to extract 
  9. smaller files for use with database managers, word processing 
  10. programs, text editors or even spreadsheet programs. 
  11.  
  12. SIX files are included within SACREP.ARC.  This file, SACREP.TXT, 
  13. provides some background and simple instructions.  The files 
  14. SAC1REP.FRM, SAC2REP.FRM and SAC3REP.FRM are report format files. 
  15. SAC50BLK.DBF is an empty datafile to provide the correct format for 
  16. converting SAC50 text files into the DBF format needed by SACREP.  The 
  17. main program is SACREP.EXE. 
  18.  
  19. SAC 5.0 is distributed with files in an archived status.  If you used 
  20. the INSTALL.BAT program, it unarcs the four data files.  For hard disk 
  21. users, it appended the four data files into a single file - SAC50.TXT.  
  22. If you do not have a hard disk, you can work with the four individual 
  23. data files, SAC50B.TXT through SAC50E.TXT.  
  24.  
  25.                 The Main Menu
  26.  
  27. Execute the program by entering SACREP.  This will bring up the main 
  28. menu, which has nine menu options. The first option produces reports 
  29. based on Constellations.   The second option generates reports based 
  30. on a range of coordinates.  Option three creates a database extract 
  31. for a Constellation.  Option four creates a database extract based on 
  32. Coordinates.  Option five will append previously extracted small data 
  33. files into a larger file. The sixth option will create or update the 
  34. constellation index file for the database.  Option Seven will display 
  35. the database entry for a single option.  The eighth option will 
  36. convert the SAC50.TXT file(s) to the DBF file format needed for all 
  37. the other options.  Option zero is an Exit.  
  38.  
  39. The first time you use SACREP, the SAC50.TXT file(s) need to be 
  40. converted to a DBF file format.  This is Option 8 from the main menu 
  41. of SACREP.  Once you have converted the data, you could delete the 
  42. SAC50.TXT files, but you probably want to maintain your original set 
  43. of ARC files in case you need them in the future.
  44.  
  45. The program uses SAC50 as the database default and would assume that 
  46. the file is in the same subdirectory as the program.  Many users will 
  47. prefer to customize their database and work with an extract of the 
  48. full database.  (Why include objects that are below your horizon for 
  49. routine reports?)  If you create extracted databases with option 3 or 
  50. 4, you will need to enter that new filename on the main menu, so 
  51. SACREP will know where to find the database.  The file MUST be in a 
  52. DBF format to work with the program!   If you are using SACREP with 
  53. floppy disks, include the drive letter when you indicate the filename. 
  54.  
  55.                Producing Reports
  56.  
  57. 1.  To run an observing list based on a Constellation, the user is 
  58. prompted to enter the standard three letter abbreviation for the 
  59. desired constellation. (See the note file that came with SAC 5.0 for a 
  60. list of those abbreviations.)  The program is not upper/lower case 
  61. sensitive.  
  62.  
  63.  
  64. Next, you enter a range of magnitudes for brightest magnitude, then 
  65. dimmest magnitude.  The programs expect a range from -1 to 99.9 
  66. magnitude.  (Some objects do not have magnitudes - dark nebulae.  
  67. These are listed in the database with a value of 79.9 as dark clouds 
  68. do not have a magnitude.  All other objects have a "normal" catalog 
  69. magnitude rating.  A few objects with unknown magnitudes are listed 
  70. with 99.9 for their magnitude.  
  71.  
  72. You next indicate whether to route the report to a disk file (d) or a 
  73. printer (p), with the printer as a default.  The disk file will be an 
  74. ASCII file complete with page headings, etc.  The next choice is to 
  75. choose a particular type of object for the observing list, such as 
  76. GALXY for galaxies, DRKNB for Dark Nebula, etc.  See the SAC50 note 
  77. file for the full list of abbreviations.  The default option, ALL__ 
  78. will provide a complete listing of all object types that meet the 
  79. other selection criteria.
  80.  
  81. There are 3 report formats to choose from.  Report type 1 has an 80 
  82. column format, Format 2 is 128 columns; and Format 3 runs 235 columns.  
  83. All 3 provide a left margin for putting the reports in a binder.  The 
  84. program pauses for a printer check.  To keep it simple, I did not 
  85. create a printer table, so you need to make sure that the printer is 
  86. already set for the desired typefont.  If you send the report to a 
  87. disk file, a filename must be entered.  If no file extension is 
  88. provided, the program will automatically append the extension of 
  89. '.txt'.  The filename should not be one that is currently in use. 
  90.  
  91. The last choice is to hit enter to process the report or enter 0 to 
  92. return to the main menu.  
  93.  
  94. 2.  Main Menu Option Two provides reports on a range of coordinates, 
  95. object types and magnitudes.  The program expects whole numbers 
  96. between 0 and 24, for right ascension.  It expects whole numbers 
  97. between -90 and 90 inclusive for declination.  The other choices 
  98. follow the same format as described for the Constellation report 
  99. option. 
  100.  
  101. 3 & 4.  Database extracts allow you to extract all of the database 
  102. information fields, based on the same type of selection criteria used 
  103. by the two report generator options.   If the database is used by 
  104. someone who never observes objects fainter than 13th magnitude, and 
  105. never lower than -40 degrees declination, those criteria could be used 
  106. to create a much smaller version of the SAC50 database.  That database 
  107. would then be much faster than using the full blown version.   The 
  108. Database extracts for Coordinates uses the same selection criteria as 
  109. the Coordinate report generators - except the output goes to a file 
  110. whose name you must supply.  
  111. The text file version has all fields delimited with double quotes and 
  112. separated by commas.  This type of file can be read by most database 
  113. programs and can be imported into most spreadsheet software.  The DBF 
  114. extract file version, is in a standard dBASE file format.  
  115.  
  116. 5.  Main Menu Option Five can be used to append files with the same 
  117. format into the other DBF files.  This is an easy way to create a 
  118. variety of smaller observing databases.  For example, the user could 
  119. create individual constellation extracts, then append each file to 
  120. have a new combined database such as seasonal databases based on the 
  121. available constellations.  We have two warnings.  FIRST, the program 
  122. will append one file to another.  So if you create a database based on 
  123. coordinates, then append a constellation extract of an constellation 
  124. within those same coordinates, you would now have duplicates of some 
  125. objects.  SECOND, if you plan to use the extracts to run reports, be 
  126. sure to run the INDEXING option, described below.
  127.  
  128. 6.  The distribution copy of SAC 5.0 is sorted by RA and Dec.  SACREP 
  129. takes advantage of this sort for the Coordinate based reports and 
  130. extracts.  Option Six from the main menu will create an index file to 
  131. provide reports and extracts sorted by Constellations.
  132.  
  133. 7.  Main Menu Option 7 will provide a listing of the data for a 
  134. particular object.  You can enter the Name or Other Name of an object.  
  135. For example, NGC 1068 is also known as M 77. Be sure to use the name 
  136. formats as described in the SAC 5.0 documentation files.
  137.  
  138. 8.  Option 8 is used to convert the distribution database text files 
  139. to the DBF format.  If you are using a hard disk, INSTALL.BAT will 
  140. have converted the four text files into one large file called 
  141. SAC50.TXT.  This option will convert that file to SAC50.DBF.  If you 
  142. using floppy disks, each of the four data text files could be 
  143. individually converted to a dbf file.  SAC50B.TXT to SAC50B.DBF, etc.
  144. Be sure to index the converted file(s) with Option 6 prior to use.
  145.  
  146.                For More Report Options
  147.  
  148. SACREP will not meet all conceivable needs.  If it does not provide 
  149. what you want, get a good database manager program and use it!  We 
  150. have used dBASE software through several generations of evolution, and 
  151. are comfortable with it.  There are plenty of other good database 
  152. programs on the market.  Most will be able to convert either the 
  153. SAC50.TXT files or the SAC50.DBF files to a format they can use. 
  154.  
  155.                IF You Just HAVE to Know More 
  156.  
  157. The SACREP programs were written in dBASE III plus, and compiled using 
  158. Clipper.  SACREP.EXE is hereby placed in the Public Domain and may be 
  159. freely distributed as is, provided no fees are charged.  However, it 
  160. must be distributed with all files intact. 
  161.  
  162. As the programmers, we assume NO responsibility or liability for the 
  163. program's use or misuse.  It is offered solely as a goodwill gesture 
  164. to help support those whose astronomical skills exceed their computer 
  165. programming skills! 
  166. If the user finds a burning need to send someone money for this 
  167. product, please do NOT send any money to us.  This project was a labor 
  168. of love. Instead, please consider contributing time or money to your 
  169. local amateur astronomy club.  Tell 'em AJ and Danny sent you! 
  170.  
  171. We welcome suggestions for improvements, as there are lots of dBASE 
  172. users with better skills than mine!  Should you want to get a copy of 
  173. the original source code, contact: 
  174.  
  175.           Dan Ward                      A.J. Crayon 
  176.           11817 North 55 Street         13819 North 37th Avenue 
  177.           Scottsdale, AZ  85254         Phoenix, AZ  85023 
  178.  
  179. You can also leave a message for Dan Ward on the AstroForum in 
  180. CompuServe (id 76117,1725), where he is the Library Manager. 
  181.  
  182. Please DO NOT telephone us and get us in trouble with the WIVES and 
  183. KIDS!!!!!! They think our time at home is supposed to be spent with 
  184. them - not answering technical questions on the phone!  And besides, 
  185. you might ask questions that we don't know how to answer and thereby 
  186. make us feel foolish in front of the family! <grin> 
  187.  
  188.                    Database Trivia 
  189.  
  190. We hereby express my sincere thanks to the entire Saguaro Astronomy 
  191. Club Database Project team, who gave us advance extracts of SAC50 to 
  192. help develop this program.  Their dedicated efforts have provided 
  193. astronomers with a fantastic observing database!  Our limited efforts 
  194. to prepare this report generator program and install program are a 
  195. mere drop in the bucket, when compared with their work! 
  196.  
  197. Nearly all of the SAC 5.0 team members belong to the Saguaro Astronomy 
  198. Club (SAC) in the Metro Phoenix area of Arizona, hence the name of the 
  199. database.  (A Saguaro is the large variety of cactus often seen in 
  200. Western movies and quite common around Phoenix.  Saguaros are massive 
  201. plants with large upturned arms, and are only found in Arizona and 
  202. Mexico.) 
  203.  
  204. A.J. Crayon wrote SPROGS, a series of dBASE programs for the original 
  205. release of SAC 4.0.  Dan Ward wrote SACREP 4.0. which was also 
  206. released with SAC 4.0.  We combined forces to create SACREP 5.0, which 
  207. is hopefully a blend of the best of both.
  208.  
  209. dBASE and dBASE III are registered trademarks of ASHTON-TATE.  CLIPPER 
  210. is a registered trademark of Nantucket Corporation.  We hereby 
  211. recognize their ownership to said terms throughout this document, and 
  212. also respectfully kowtow in their directions for making our lives 
  213. easier via the introduction of those stated products!  
  214.  
  215.       A.J. Crayon and Dan Ward   - May 15, 1989 
  216.